home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / c3d2raw.zoo / README < prev    next >
Text File  |  1994-04-06  |  5KB  |  118 lines
  1. Atari CAD-3D to RAW Triangles
  2.  
  3. cad3d2raw is a simple filter for converting Atari CAD-3D files (created
  4. by CAD-3D 2.x, CyberSculpt, and various tools from Lexicor and others)
  5. to the RAW triangle format supported by raw2pov.  This is intended as a
  6. method of getting CAD-3D objects into your POV-Ray scenes for
  7. raytracing; a nice side-effect is that raw2pov can output Vivid and
  8. Polyray scene files as well, so users of those raytracers will be able to
  9. use CAD-3D objects in their scenes as easily as POV-Ray users.
  10.  
  11. cad3d2raw was written from scratch by Chris Herborth
  12. (cherborth@semprini.waterloo-rdp.on.ca), who retains all rights to the
  13. program and its source code; the source code and cad3d2raw binaries
  14. created from the source code may be freely distributed.  You can use the
  15. source code in your own programs as long as I am given credit, and you
  16. can compile and use the cad3d2raw program for whatever purposes you'd
  17. like.  If you sell cad3d2raw to anyone, you're a jerk.  Contact me if
  18. you'd like to include cad3d2raw in something like a CD-ROM collection or
  19. a shareware/Public Domain collection.
  20.  
  21. If you use cad3d2raw for any commercial purposes, or if you use it to
  22. create any nice scenes, I would appreciate it if you'd send me a copy of
  23. the image you've rendered, preferably in JPEG format.
  24.  
  25. Compiling cad3d2raw
  26.  
  27. To compile cad3d2raw:
  28.  
  29. 1) Edit the Makefile.  You will probably have to change CC and possibly
  30.    CFLAGS to match what your compiler expects; things like Microsoft C
  31.    and Borland C seem to go out of their way to have incompatible
  32.    command-line switches.
  33.  
  34. 2) If you are compiling for a little-endian CPU (ie, Intel, some MIPS,
  35.    VAX, probably one or two blasphemous others), add -DLITTLE_ENDIAN to
  36.    CFLAGS; the code already takes care of converting the big-endian
  37.    CAD-3D files into little-endedness for you.
  38.  
  39. 3) If you are compiling for an operating system that insists on having a
  40.    file's extension decide what an executable is, you'll need to change
  41.    PROGRAM.  DOS and OS/2 need .exe, Atari TOS needs .ttp (unless you
  42.    use the Minix filesystem under MiNT).
  43.  
  44. 4) Type 'make' and hit return.  If you don't have a make program, get
  45.    one.
  46.  
  47. 5) In a short time, you should have a cad3d2raw executable to fondle and
  48.    love...  enjoy!
  49.  
  50. Using cad3d2raw
  51.  
  52. cad3d2raw is fairly easy to use, and has only a few options.  Usage is:
  53.  
  54. cad3d2raw [options] input.3d2 [output.raw]
  55.  
  56. where the options and the output filename are optional.
  57.  
  58. The available options include:
  59.  
  60. -c    Use the colours from the CAD-3D file (makes a Fractint RAW file);
  61.     this will preserve the object colours.  Remember to add -fc to the
  62.     raw2pov command line if you use this!
  63.  
  64. -b    Use the colour base from the CAD-3D file (makes a Fractint RAW
  65.     file); contrary to the usage message in cad3d2raw, this doesn't
  66.     really work better... it seems to produce about the same effect as
  67.     using -c.  This is a bug/feature and will probably go away in
  68.     the next version, if there is one.  Remember to add -fc to the
  69.     raw2pov command line if you use this!
  70.  
  71. -v    Produce verbose output.  This is good if you've got a slow manchine
  72.     and want some sort of indication that cad3d2raw is actually doing
  73.     some sort of work.
  74.  
  75. -d    Produce debugging output (ie, extra-verbose).  This isn't too useful
  76.     unless you think you've got a corrupt CAD-3D file.
  77.  
  78. Less useful options include:
  79.  
  80. -h    Print the usage message.
  81.  
  82. -?    Same as -h.
  83.  
  84. -V    Prints version info.  On a some systems, "ident cad3d2raw" will
  85.     give you the same information.
  86.  
  87. Sources of CAD-3D Objects
  88.  
  89. Lots of great CAD-3D objects can be found on these Internet FTP sites:
  90.  
  91. atari.archive.umich.edu:/atari/Graphics/Elwell
  92.  
  93. This is the official FTP site for the Atari community; unfortunately,
  94. there doesn't seem to be too many CAD-3D objects here.  Try connecting
  95. to msdos.archive.umich.edu if atari.archive.umich.edu is busy.
  96.  
  97. avalon.chinalake.navy.mil:/pub/objects/3d2
  98.  
  99. This site has lots of different objects in lots of different formats, as
  100. well as documentation for the formats and converters.  If you can't get
  101. on here, there is a mirror at wuarchive.wustl.edu in
  102. /graphics/graphics/mirrors/avalon.chinalake.navy.mil/objects/3d2.  The
  103. avalon.chinalake.navy.mil directory path may be wrong, I've never been
  104. able to connect there.
  105.  
  106. ftp.std.com:/pub/atari/Graphics/Lexicor/3D2
  107.  
  108. This is the official FTP site for Lexicor Graphics; there are lots of
  109. objects and animations available here, but mostly in Atari formats. 
  110. Lexicor is the NuTek of the Atari community.  This is also Kibo's home
  111. site.
  112.  
  113. There are also a tonne of CAD-3D objects available on GEnie, and
  114. probably on CompuServ as well.
  115.  
  116. If you run a BBS that has CAD-3D objects available, let me know, and
  117. I'll include it here in future releases.
  118.